home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 7: Sunsite / Linux Cubed Series 7 - Sunsite Vol 1.iso / system / backup / lnx-bkp-.000 / lnx-bkp- / Lnx-Bkp-Util-v1.10.Readme < prev   
Text File  |  1995-02-24  |  9KB  |  213 lines
  1.  
  2.  
  3.                 Welcome to L.B.U, the Linux Backup Utility v1.10
  4.           by : Jonathan Warburton-Brown @ 1995
  5.                (jwb@uvo.dec.com)
  6.  
  7.     Ever since I first started using Linux (in 1991) I have been an 
  8.     avid  supporter of both it and the principles it upholds. I have 
  9.     also wanted to put back into the great Internet pool some small 
  10.     offering that would contribute to the Linux project. This is it. 
  11.  
  12.     Version 1.10 is the second incarnation of L.B.U. When I first coded 
  13.     L.B.U v1.00 it was done largely as an exercise to teach myself 
  14.     shell-script programming but I received very favourable feedback from 
  15.     people who have made use of it. L.B.U is even being used on at least 
  16.     one commercial site !!!  This feedback together with some great 
  17.     suggestions for improvements prompted me to make time to code this 
  18.     version. Time is in short supply for me and this release does not 
  19.     cover every suggestion I have received but it does add more 
  20.     flexibility and usability to the utility.
  21.  
  22.     One of the enhancements requested by several people is the ability to 
  23.     choose the 'backup engine' so that it could be either tar (which it 
  24.     is now), cpio or afio. This would have taken more time than is 
  25.     currently available to me, but I am thinking about it for a future
  26.      release. Sorry it didn't make it this time.
  27.  
  28.     A big thank you though to everyone who mailed me with ideas (and 
  29.     praise as well :-) )...  THANK YOU !
  30.  
  31.     L.B.U does not make any attempt, at this stage, to be a full or 
  32.     fool-proof backup solution. If you have a copy of this  utility it 
  33.     comes to you under the terms of the GNU GPL and you are free to use/
  34.     abuse it as you will. I take absolutely NO responsibility  for any 
  35.     consequences that arise from its use. If you make any changes I  would
  36.     appreciate my name remaining in the credits for it. After all it 
  37.     took me a lot of hard work to get it to where it is today ;-).
  38.  
  39.     L.B.U is my very first attempt to put something together for use in 
  40.     the Linux community and my first attempt at shell-script programming 
  41.     so  please don't laugh too hard. Mail is always fun to receive if you 
  42.     have any comments or suggestions or if you find some use for this 
  43.     utility and besides, it lets me track L.B.U's propagation around the 
  44.     globe 8-). If you do decide to mail me could you include where you 
  45.     are from (ie geographically) because its not always easy to guess from
  46.     the mail address. Sadly I do not always have time to respond to mail... 
  47.     but it doesn't mean I don't enjoy hearing from you though !!
  48.  
  49.     I do re-iterate that this package (program, manuals, help-files etc) 
  50.     has been put together in some haste. It seems to work okay for me as 
  51.     far as I have tested it but never a truer saying was coined than 
  52.     'There is always at least one more bug'. 
  53.  
  54.     There are surely bugs in the program, so let me know about them too !!
  55.  
  56.     While I will consider seriously any suggestions for enhancements, I 
  57.     can only work on this in the spare time I find and can therefore 
  58.     not guarantee to incorporate any changes or even release any further 
  59.     versions. Time will tell.
  60.  
  61.     INSTALLATION
  62.     ============
  63.  
  64.     My system is running Slackware v2.1.0 with a 1.1.90 kernel (though
  65.     L.B.U should be kernel independent) It works on this setup so I
  66.     hope it will work on your.
  67.  
  68.     Log in to your system as root.
  69.  
  70.     cd /
  71.  
  72.     zcat Lnx-Bkp-Util-v1.10.tgz | tar -xvpf -
  73.  
  74.     This will create a directory /usr/lib/LBU where all the L.B.U
  75.     associated files will be kept. the L.B.U executable (lbu) will
  76.     be placed in /usr/bin.
  77.  
  78.     If these default locations and names are not acceptable to you
  79.     look at the script file itself for a few changeable items. Other
  80.     than that you'll have to edit the body of the script itself.
  81.  
  82.     Using the dialog utility is best with con80x25 in your terminfo
  83.     database. By default it should be in
  84.  
  85.         /usr/lib/terminfo/c.
  86.  
  87.     When you restore the distribution archive con80x25 will go into
  88.     your current directory. Move it to the above location if necessary
  89.     but if you have one... leave well enough alone. I only include it 
  90.     in the distribution because when I came to write this utility I
  91.     realised I did not have it and had to get it from elsewhere. Who
  92.     knows, its inclusion in the distribution may save someone a little
  93.     grief.
  94.  
  95.     If all else fails then set your TERM environment variable to be
  96.     vt100.
  97.  
  98.     Similarly I have included a copy of the new version (0.5) of dialog 
  99.     just in case. Use it if you need to. The default location for dialog 
  100.     is /bin. You may well already have a version of dialog on your
  101.     system but this latest version gives nice 3d effects etc and I 
  102.     recommend its use. Dialog 0.5 should be used with ncurses 1.8.5 or
  103.     later. I also recommend keeping your original version of dialog handy
  104.     until you are satisfied that the new version works on your system.
  105.     I did try using it on another (older) release of Slackware Linux
  106.     and ended up with horrible colours. If it doesn't look really nice
  107.     then chances are its not working to maximum potential on your
  108.     system.
  109.     
  110.     L.B.U makes a few assumptions about the location of the required
  111.     binaries (at, atrm, atq, grep, awk, crond, dialog, ls, cut, touch
  112.     date, chmod, bc and tar) and assumes that they are in your PATH.
  113.   
  114.     That is about it really. To invoke L.B.U, just type lbu at the
  115.     command prompt.
  116.  
  117.  
  118.  
  119.     THIS RELEASE
  120.  
  121.      o  There have been numerous tidy-ups in the code but I'll not bore
  122.     you with the sordid details. The code is probably still a bit 
  123.     ropy anyway since I'm still very much in the learning phase of 
  124.     shell programming.
  125.  
  126.      o    There are various flags that may be set at the top of the lbu
  127.     script.
  128.  
  129.      o  I have removed the restriction that only root could make backups. 
  130.     L.B.U should now be pretty much mutli-user. One word of caution
  131.     though no device/file locking is implemented which means two
  132.     people could try to back up to the same file/device at the same
  133.     time. This is mitigated somewhat by the fact that I have retained
  134.     the code which disallows more than one L.B.U session to be running
  135.     at once.
  136.  
  137.     Also, the Scheduling function is restricted to root. Whilst most
  138.     of the code is in place for multi-user scheduling it does not work
  139.     fully yet. Anyway, it seemed to me that users creating many
  140.     schedules might not be a desirable thing !
  141.  
  142.     If this multi-user functionality presents a problem, I suggest for
  143.     the moment, as system manager, that you limit L.B.U usage to root
  144.     with permission masks and/or set the lbu_root_only flag to yes by
  145.     editing the lbu script.
  146.  
  147.      o     An oversight in version 1.00 was that the first letters of menu
  148.            items were not unique. This has now been corrected and allows fast
  149.      menu hopping. For example, on the main menu, to get to any item
  150.     visible on the the screen there are three methods.
  151.  
  152.         o Use the arrow keys 
  153.         o Use the plus (+) and minus (-) keys 
  154.         o Type the first letter of the menu item
  155.  
  156.      o     Device selection has been made a little more bullet-proof.
  157.     Entering an asterisk (*) will now just throw you into the
  158.     help-screen. Any spaces included (in error naturally) in the
  159.     device name will be converted to a an underscore.
  160.  
  161.      o     File/Directory selection has been made much more flexible and now
  162.     caters for wild-carding. Note that if an item is entered without
  163.     wild carding its validity is checked (ie does it exist). If
  164.     wild-carding is used then checking for that item is not
  165.     performed.
  166.  
  167.      o     Under the Options sub-menu there is one additional item entitled
  168.     Enable/Disable file exclusion. this switch activates/deactivates
  169.     an exclusions file which L.B.U uses when performing its
  170.     operations.  Please see the section on the Exclusion File for
  171.     more information.
  172.  
  173.      o     The date validation in the Scheduling sub-menu has been tightened
  174.     up and now includes leap year checking.
  175.  
  176.      o     There is a Compare facility which allows reporting of differences
  177.     between a previously performed backup and the current
  178.     file-system.
  179.  
  180.      o     There is a Write function which saves the current configuration to
  181.     disk. Details saved are :
  182.  
  183.         o Device selection 
  184.         o File/Dir selection 
  185.         o All options from the Options sub-menu
  186.  
  187.     If there is no save file ($HOME/.lburc) then, when invoked, L.B.U
  188.     will proceed straight to the main menu. If however L.B.U finds a
  189.     save file a loading screen is presented and when loading is
  190.     complete (a few seconds) L.B.U proceeds to the main menu with the 
  191.     previously saved selections already in force.
  192.  
  193.      o     The ability to create/modify an exclusions file. This file may
  194.     contain filenames (wild-carding allowed) which should be ignored
  195.     by the backup. See the section on Exclusions for more
  196.     information.
  197.  
  198.      o     No credit for me here, but all credit to Savio Lam. I have
  199.     included in the L.B.U v1.10 distribution version 0.5 of his
  200.     smart dialog utility which allows L.B.U to look so pretty.
  201.     Thanks Savio.
  202.  
  203.     A postscript manual for L.B.U will be installed into
  204.     /usr/lib/LBU/doc
  205.     
  206.     Enjoy, and thanks to all Linuxers everywhere for their contribution
  207.     to the success of Linux.
  208.  
  209.  
  210.     Jonathan Warburton-Brown
  211.     ------------------------
  212.  
  213.